Installatie handleidingen CAK 2.0


Let op de volgorde voor deze update:

  • Eerst de Aeolus Back database
  • Bestanden van Aeolus back
  • EbbService bestanden
  • Dan de cak API
  • Worker
  • Queue

Aeolus.Eb.Queue

Initiële installatie

1. Maak een map aan waar de bestanden in komen.
2. Kopieer de nieuwe bestanden naar de map.
3. Hernoem het appsettings.sample.json bestand, naar appsetting.json
3a. Zet de Juiste tenant id in het json bestand.
3b. Zet de juiste url voor Seq.
3c. Pas de connectiestring aan, naar de juiste database.
4. Indien nodig installeer de juiste .Net versie zoals aangegeven in de betreffende update.
5. Start de queue handmatig op, zodat bevestigd kan worden of het programma goed werkt.
6. Maak een taak aan die elke 2 uur draait, en die de queue opstart.


Update

1. Zet de taak uit.
2. Maak een backup van de map.
3. Verwijder alle bestanden en submappen in de map, behalve het appsettings.json bestand.
4. Kopieer de nieuwe bestanden naar de map.
5. Pas eventueel het appsettings.json bestand aan, naar de instructies van de betreffende update.
6. Indien nodig installeer de juiste .Net versie zoals aangegeven in de betreffende update.
7. Start de queue handmatig op, zodat bevestigd kan worden of het programma goed werkt.
8. Zet de taak weer aan.


Update versie 2.0

Systeemeisen: .Net 6.0 zie hiervoor dotnet.microsoft.com/en-us/download
Appsettings (in de installatiemap staat een appsettings.sample.json bestand)
- Voeg een Tenant.Id toe. De juiste tenantId staat in de begeleidende mail, of neem contact op met Horlings & Eerbeek.

"Tenant": {
"Id": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX”,
},

- Pas de Serilog sectie aan. Zie Serilog voor meer informatie.


Aeolus.CAK.Worker.Back

Dit programma werkt de controle lijsten binnen Aeolus Back bij met de informatie uit de CAK API.


Initiële installatie

1. Maak een map aan waar de bestanden in komen.
2. Kopieer de nieuwe bestanden naar de map.
3. Hernoem het appsettings.sample.json bestand, naar appsetting.json
3a. Zet de Juiste tenant id in het json bestand.
3b. Zet de juiste url voor Seq.
3c. Pas de connectiestring aan, naar de juiste database.
4. Indien nodig installeer de juiste .Net versie zoals aangegeven in de betreffende update.
5. Start het programma handmatig op, zodat bevestigd kan worden of het programma goed werkt.
6. Maak een taak aan die elke nacht een uur draait en die het programma opstart.


Update

1. Zet de taak uit.
2. Maak een backup van de map.
3. Verwijder alle bestanden en submappen in de map, behalve het appsettings.json bestand.
4. Kopieer de nieuwe bestanden naar de map.
5. Pas eventueel het appsettings.json bestand aan, naar de instructies van de betreffende update.
6. Indien nodig installeer de juiste .Net versie zoals aangegeven in de betreffende update.
7. Start het programma handmatig op, zodat bevestigd kan worden of het goed werkt.
8. Zet de taak weer aan.


Update versie 2.0

Systeemeisen: .Net 6.0 zie hiervoor dotnet.microsoft.com/en-us/download
Appsettings (in de installatiemap staat een appsettings.sample.json bestand)
- Voeg een Tenant.Id toe. De juiste tenantId staat in de begeleidende mail, of neem contact op met Horlings & Eerbeek.

"Tenant": {
"Id": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX”,
},
- Pas de Serilog sectie aan. Zie Serilog voor meer informatie.


Aeolus.CAK.Service

Deze API is de basis van onze CAK module.


Initiële installatie

1. Maak een map aan en kopieer de bestanden hier naar toe.
2. Start IIS en maak een nieuwe site aan.
3. Zorg dat de .net versie van de applicatie op ‘geen beheerde code’ staat.
4. Hernoem het appsettings.sample.json bestand, naar appsetting.json
4a. Zet de juiste url voor Seq.
4b. Pas de connectiestrings aan, naar de juiste database.
5. Restart de site en recycle de applicatie (nodig na elke wijziging in het appsettings.json bestand).
6. Test de site door in postman naar http://url:poort/api/versie te gaan.
7. Pas in de Aeolus back de API instellingen aan. Standaard gebruikt de API geen gateway.


Update

1. Zet de site en de applicatie stop.
2. Maak een backup van de map.
3. Verwijder alle bestanden en submappen in de map, behalve het appsettings.json bestand.
4. Kopieer de nieuwe bestanden naar de map.
5. Pas eventueel het appsettings.json bestand aan, naar de instructies van de betreffende update.
6. Indien nodig installeer de juiste .Net versie zoals aangegeven in de betreffende update. 7. Start site en de applicatie weer.
8. Test de site door in postman naar http://url:poort/api/versie te gaan.
9. Pas in de Aeolus back de API instellingen aan. Standaard gebruikt de API geen gateway.


Update versie 2.0

Systeemeisen: .Net 6.0 zie hiervoor dotnet.microsoft.com/en-us/download
Database wijzigingen:
-Zorg dat het script ES-Gemeentenaam.txt is uitgevoerd op de AeolusES database.
-Cak 2.0 gebruikt een nieuwe structuur, de structuur dient aangemaakt te worden met het script CAK20.sql structuur.txt \
  • Let op dit script is alleen voor MS SQL database. Een keuze kan gemaakt worden om de tabellen in de database van Aeolus Back te plaatsen. Alleen mogelijk indien het MSSQL is.
  • De bestanden kunnen ook geplaatst worden in de AeolusES database
  • Of een nieuwe database AeolusCAK kan worden aangemaakt.
Appsettings (in de installatiemap staat een appsettings.sample.json bestand).
Voeg een OIDC sectie toe.
"OIDC": {
"Authority": "https://OAuth2.hene.nl/"
},
Pas de connectiestrings aan. LET OP: de naamgeving is veranderd.
Pas de Serilog sectie aan. Zie Serilog voor meer informatie.

Conversie naar 2.0

Een conversie is nodig om de oude gegevens naar de nieuwe tabellen te zetten.

Een call naar de api zal deze conversie starten.

Start postman (zoals beschreven in Postman)
Zorg dat de tenantId en de authorisatie goed staat
Maak een POST call aan naar http://url:poort/api/onderhoud/ConvertToV2
Zet in de body:
{
"Aantal":1000000,
"ExcludeAlreadyConverted":false
}
Vergeet niet aan de rechterkant voor JSON te kiezen
Klik op Send

LET OP: de conversie kan afhankelijk van de hoeveelheid data 30 tot 45 minuten duren.

Na afloop staat in het responsescherm van Postman het resultaat. Indien er fouten zijn opgetreden, dan staat dit in de response. Kopieer in dat geval de response en stuur deze naar Horlings & Eerbeek.

ConvertToV2

Postman

Postman is een ‘gratis’ programma waarmee http requests gemaakt kunnen worden. Binnen Aeolus wordt het bijvoorbeeld gebruikt om functies binnen een APIaan te roepen, waarvoor geen userinterface is. Voor een uitgebreide handleiding zie, https://www.postman.com/

Natuurlijk kan ook een ander pakket gebruikt worden met dezelfde functionaliteiten.

TenantId

Elk request naar een Aeolus APIheeft een TenantId nodig. Deze kan opgegeven worden in de header.

- Ga naar de header tab.
- Geef als key: tenantid (let op, alleen maar kleine letters).
- Geef in het value veld, de juiste tenant id op in hoofdletters.
TenantId

Authorization

Bijna alle api call werken met het OAuth 2.0 protocol. Om dit protocol te gebruiken dient Postman op onderstaande manier ingericht te worden.

1. Klik op de Authorization tab binnen Postman.
2. Kies bij type voor : OAuth 2.0
3. Vul de velden in zoals hieronder in gegeven.
4. ClientId en ClientSecret zijn te vinden onder de systeeminstellingen binnen Aeolus Back.
5. Klik op Get New Access token.
6. Indien het gelukt is, klik op Use Access token.
7. Indien het niet gelukt is, controleer de velden en probeer of een request naar https://oauth2.hene.nl wel lukt.
8. Mocht dit niet lukken dan kan het zijn dat de firewall dikt tegenhoudt.


OAuth2.0

Serilog

Serilog is een logging framework wat door Aeolus wordt gebruikt. In het appsetting.json bestand van het betreffende programma kunnen bepaalde zaken worden ingesteld.

De standaard configuratie staat in de appsettings.sample.json. Voor meer informatie en de mogelijkheden, zie https://serilog.net

.Net framework

Bijna alle Aeolus applicaties gebruiken het Microsoft .Net Framework. Welke versie zal bij het betreffende programma of update worden aangegeven.

Op Download .NET 6.0 Runtime (microsoft.com) is de juiste versie en download te vinden.